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Abstract 

This  document  presents  a  data  dictionary  for  oceanographic  netCDF 
data  files.  Commonly  used  words  are  abbreviated.  Abbreviations  are  then 
combined  to  make  sentence-like  variable  names  that  describe  the  contents 
of  the  variable.  The  goal  is  to  facilitate  netCDF  file  use  by  making  the 
CDF  form  of  the  data  self-documenting. 


The  Institute  for  Naval  Oceanography  (INO)  is  operated  by  the 
University  Corporation  for  Atmospheric  Research  (UCAR)  under 
sponsorship  of  the  Naval  Research  Laboratory  (NRL).  Any  opinions, 
findings,  and  conclusions  or  recommendations  expressed  in  this 
publication  are  those  of  the  author(s)  and  do  not  necessarily  reflect  the 
views  of  NRL. 
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1.0  INTRODUCTION 


The  netCDF  file-program  interface  (Rew  [3])  provides  a  machine 
independent  view  of  data  files.  To  simplify  the  file-human  interface,  a 
few  basic  utilities  (re:  ncdump,  ncgen)  are  provided.  They  allow  people  to 
peruse  the  data  file  in  a  readable  fashion  via  the  Common  Data 
Language  (CDL).  This  dictionary  is  an  addendum  to  CDL,  proposing  standard 
abbreviations  that  describe  the  contents  of  the  data  files  without  further 
references  needed.  It  is  an  attempt  to  make  the  CDL  form  of  the  netCDF 
files  self-documenting.  It  is  based  on  the  NEPRF  Data  Dictionary  [2]. 

2.0  DATA  DICTIONARY 

This  section  presents  the  data  dictionary.  All  words  are  abbreviated 
to  four  or  less  letters.  Less  than  four  is  acceptable  only  for  words  less 
than  four  letters,  or  for  well-established,  commonly-accepted 
abbreviations.  The  abbreviations  selected  followed  some  general 
guidelines.  The  first  guideline  was  to  drop  all  vowels  when  possible, 
except  when  the  first  letter  is  a  vowel.  We  rarely  drop  the  first  letter  in 
the  word  unless  it  is  a  number  or  a  commonly-used  English  language 
abbreviation.  If  we  still  need  more  reduction,  we  next  pick  the  most 
important  consonants  to  retain.  Third,  a  visual  inspection  for  readability 
was  used. 

The  shorter  abbreviations  are  three  or  less  letters.  It  is  possible 
to  have  a  hierarchy  of  shorter  abbreviations.  We  first  tried  to  shorten 
an  abbreviation  by  removing  letters  from  the  end  of  the  long  abbreviation. 
When  this  was  not  unique,  we  retained  the  dominant  sounds  of 
the  accented  (stressed)  syllables  in  the  Institute  for  Naval 
Oceanography  (INO)  Technical  Memo  entitled  Software  Requirements 
Document  for  the  netCDF  Interface  with  ECMOP,  Version  1.0  [4], 

The  type  field  is  keyed: 

attr  -  attribute 
bvar  -  bit  or  logical  variable 
cvar  -  character  variable 
desc-  description 


m 


gvar-  generic  variable 
ivar  -  integer  variable 
op  -  operation 
rvar  -  real  variable 
unit  -  unit  of  measure 


Abbr  Name  Short 


abbreviated 

abbr 

abr.ab 

desc 

absolute 

abs 

al 

op 

access 

acc 

as 

op 

acoustic 

acst 

ac 

attr 

action 

actn 

atn.an 

op 

active 

actv 

av 

desc 

adjoint 

adjt 

aj 

op 

advection 

advc 

ad, a 

rvar 

age 

age 

-  - 

attr 

agency 

agcy 

age 

desc 

air 

air 

ai 

rvar 

altimetry 

altm 

al 

attr 

amount 

amt 

am 

desc 

anemometer 

anmt 

anm 

attr 

angle 

ang 

ag 

op 

anomaly 

anom 

-  - 

desc 

ansi 

ansi 

-  - 

desc 

area 

area 

ar 

op 

array 

arry 

ara 

desc 

ascending 

asc 

-  - 

attr 

assimilation 

assm 

ass, as 

op 

associative 

assc 

act 

op 

atmosphere 

atms 

af 

attr 

attached 

att 

-  - 

desc 

attribute 

attr 

at 

attr 

avhrr 

avhr 

-  - 

attr  / 

background 

bkgr 

-  - 

attr 

band 

band 

-  - 

attr 

bandwidth 

bdwh 

-  - 

desc 
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Full  Name  Abbr  Name  Short _ Type  Description 


baroclinic 

bcnc 

be 

barotropic 

btpc 

bt 

base 

base 

-  - 

beaufort 

bf  rt 

-  - 

becomes 

bcom 

-  - 

begin 

bgn 

b 

biology 

biol 

-  - 

bit 

bit 

-  - 

bitstream 

bstr 

-  - 

bogus 

bgus 

bgs 

boresight 

bors 

-  - 

bottom 

bot 

bm 

boundary 

bdry 

bd 

brightness 

brgt 

-  - 

byte 

byte 

-  - 

calculate 

calc 

-  - 

calls 

call 

-  - 

callsign 

csgn 

-  - 

calm 

calm 

-  - 

catalog 

cat 

-  - 

category 

catg 

-  - 

cell 

cell 

-  - 

Celsius 

cels 

ce 

center 

cntr 

-  - 

change 

chg 

-  - 

channel 

chan 

-  - 

characteristic 

chr 

-  - 

charge 

chrg 

-  - 

cirrus 

cirr 

ci 

classification 

clas 

-  - 

clear 

clr 

-  - 

climatology 

clmo 

emo 

cloud 

cld 

-  - 

cm 

cm 

-  - 

coast 

cst 

-  - 

code 

code 

cd 

attr 

attr 

desc 

attr  Beaufort  wind  strength 
op 

desc 

desc 

desc 

bvar 

desc 

attr  sensor  orientation 
desc 

desc  edge  or  limits 

rvar  luminance 

desc 

op 

op 

attr  call-sign  of  station  or  ship 
desc 

desc  descriptive  list  of  options 

desc  division  of  classification 

desc 

attr 

desc 

desc  modification  or  alteration 

attr 

desc 

desc  type  of  high  cloud 
desc  systematic  organization 
desc 

attr  data  pertaining  to  climate 
desc 

attr  central  memory 
attr 

op  an  encoding 
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Full  Name 

Abbr  Name 

Short 

coefficient 

coef 

c 

column 

col 

-  - 

command 

cmd 

-  - 

comment 

cmt 

-  - 

common 

com 

-  - 

compilation 

cmpl 

-  - 

complexity 

cplx 

-  - 

component 

cmp 

-  - 

computer 

cptr 

-  - 

concentration 

cone 

-  - 

condition 

cond 

-  - 

conditional 

cndl 

-  - 

confidence 

enfi 

-  - 

constant 

enst 

-  - 

contains 

entn 

-  - 

continuous 

cont 

-  - 

contour 

entr 

-  - 

control 

Ctrl 

-  - 

convective 

conv 

-  - 

convergence 

envg 

-  - 

conversion 

envn 

-  - 

copies 

copy 

-  - 

Coriolis 

corl 

cor.cl 

correction 

corr 

-  - 

count 

ent 

-  - 

country 

ctry 

-  - 

coverage 

cvrg 

-  - 

cp 

cp 

-  - 

creates 

ere 

-  - 

creation 

ertn 

-  - 

criticality 

crit 

-  - 

crossection 

xset 

-  - 

crossreference 

xref 

-  - 

cube 

cube 

cb 

current 

curr 

-  - 

curviture 

curv 

-  - 

_ Type  Description _ 

gvar 

desc 

op  order  or  instruction 

desc 

desc 

op 

op 

attr 

desc 

attr 

desc  restricting  or  modifying  factor 
op 

attr  degree  of  certainty 

attr 

op 

desc 

desc  isoiine 
desc 
rvec 
op 

op  transformation  between  states 

op 

op 

op  to  meet  a  standard 

attr  Numeric  value  for  cardinality 

desc 

desc  extent  of  coverage 
desc  central  processor 
op 
op 

desc 

op 

op 

desc 

rvar 

rvar 


Full  Name 

Abbr  Name 

Short 

TvDe  DescriDtion 

cycle 

eye 

ivar 

dampen 

damp 

-  - 

op 

data 

data 

d 

gvar 

date 

date 

dt 

attr  time  in  days 

day 

day 

-  - 

attr 

decay 

decy 

dey 

-  - 

deck 

deck 

-  - 

desc  of  punched  cards 

decode 

ded 

-  - 

op 

deep 

deep 

-  - 

rvar 

delayed 

dlyd 

-  - 

op 

density 

dens 

dn 

rvar 

depth 

dpth 

dph.dp 

rvar 

depression 

dprs 

-  - 

rvar  a  curviture  upwards 

descending 

dsd 

-  - 

op 

describes 

dscr 

-  - 

desc 

description 

dsc 

-  - 

desc  Textual  appendage 

destination 

dest 

-  - 

desc 

device 

dev 

-  - 

desc 

dewpoint 

dwpt 

-  - 

rvar 

diameter 

dia 

-  - 

rvar 

dictionary 

diet 

-  - 

desc 

difference 

dif 

df 

op 

diffusivity 

diff 

di 

op 

dimension 

dim 

dm 

desc 

direction 

dir 

-  - 

desc 

directory 

dret 

-  - 

desc 

disk 

dsk 

-  - 

desc 

displacement 

dspl 

-  - 

rvar 

disposition 

disp 

-  - 

desc 

distance 

dis 

ds 

rvar 

distribution 

dist 

-  - 

desc 

diurnal 

drnl 

-  - 

desc 

domain 

dom 

-  - 

desc  limits  of  variable 

Dopier 

dplr 

-  - 

desc 

east 

e 

-  - 

desc 

echo 

echo 

-  . 

desc 
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Full  Name  Abbr-Hama  Short _ Typo  Discretion 


eddy 

eddy 

ey 

effective 

eff 

-  - 

elapsed 

elps 

-  - 

elevation 

elev 

elv.ev 

end 

end 

ed 

energy 

engy 

-  - 

executable 

xqt 

xq 

executes 

exec 

-  - 

expanded 

xpnd 

-  - 

external 

xtnl 

xt 

factor 

fetr 

ftr.fr 

fine 

fine 

-  - 

first 

1 

-  - 

flag 

flag 

f  1 

float 

flot 

fit 

flux 

flux 

f 

formal 

frml 

-  - 

friction 

fret 

fre 

front 

frnt 

-  - 

full 

full 

-  - 

function 

func 

fun.fc 

geographic 

geog 

-  - 

geosat 

gsat 

-  - 

get 

get 

gt 

GHz 

ghz 

gh 

global 

gib) 

-  - 

gravity 

grvt 

gvt 

grid 

grid 

gr.g 

ground 

grnd 

-  - 

gt 

gt 

-  - 

guess 

gues 

-  - 

heat 

heat 

he 

heavy 

hvy 

-  - 

height 

ht 

-  - 

hertz 

hz 

h 

high 

hi 

-  - 

desc 

desc 

desc 

rvar 

desc 

rvar 

desc 

op 

desc 

desc 

attr 

desc 

desc 

desc  boolean  flag 

desc 

rvar 

desc 

rvar 

desc 

desc 

op 

desc  taxonomy  of  surface  of  earth 

desc 

op 

attr 

desc  worldwide,  comprehensive 

rvar 

desc 

desc  surface  of  earth 

op  greater  than 

op  estimation 

rvar 

desc 

rvar 

attr 

desc 


Abbr  Name  Short 


horizontal 

horz 

-  - 

hour 

hour 

-  - 

hydrography 

hydr 

-  - 

identity 

id 

-  - 

image 

imge 

i  m 

inactive 

inac 

-  - 

index 

indx 

i  x 

influence 

inf  1 

i  f 

information 

info 

-  - 

infrared 

infr 

-  - 

ingest 

ngst 

-  - 

input 

iput 

ip 

insertion 

isrt 

in 

instaneous 

inst 

-  - 

instruction 

inst 

itr 

internal 

itnl 

i  t 

interval 

i  tv  1 

ivl.il,  i 

inverted 

inv 

iv,v 

i  r 

i  r 

-  - 

is 

is 

-  - 

isentropic 

isnt 

-  - 

isobaric 

isbr 

-  - 

Kilogram 

kilo 

kg 

kinematic 

knmt 

-  - 

Lagrangian 

lagn 

-  - 

land 

land 

Ind 

last 

last 

-  - 

latent 

Itnt 

-  - 

latitude 

lat 

-  - 

left 

left 

1 

length 

Inth 

-  - 

level 

1  v  1 

Iv 

light 

lit 

-  - 

list 

list 

-  - 

lit 

lit 

-  - 

load 

load 

-  - 

desc 

rvar 

attr 

desc  ident.  for  object  or  attribute 

desc 

desc 

desc 

desc 

desc 

attr 

op 

op 

op 

desc 

op 

desc 

desc 

op 

attr  infra-red 
desc  exists 

desc  equal  potential  temperature 

desc 

unit 

desc 

attr 

desc 

desc 

desc 

rvar 

desc 

gvar 

desc 

desc 

desc  any  list  of  words  or  numerals 

attr  info  about  lit  data 

desc 
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location 

Ictn 

-  - 

desc 

logical 

logo 

ig 

desc 

long 

long 

-  - 

-  - 

longitude 

Ion 

-  - 

rvar 

low 

low 

1  w 

desc 

It 

It 

-  - 

op  less  than 

lu 

lu 

-  - 

desc  logical  unit 

maps 

maps 

mps 

op 

marine 

marn 

-  - 

desc 

mask 

mask 

msk.ms  op 

mass 

mass 

-  - 

rvar 

matches 

mtch 

-  - 

op 

maximum 

max 

-  - 

op 

mean 

mean 

mn 

op 

meander 

mand 

-  - 

desc 

meters 

mtrs 

mtr.mr 

unit 

method 

mthd 

mt 

attr 

middle 

mid 

m 

desc 

millibar 

mb 

-  - 

attr 

minimum 

min 

-  - 

op 

minutes 

mnts 

-  - 

attr 

missing 

miss 

-  - 

desc 

mixed 

mixd 

-  - 

desc 

model 

modi 

mdl 

desc 

modifies 

mdfy 

-  - 

op 

molecular 

mlcr 

-  - 

attr 

momentum 

mmtm 

mm 

rvar 

moored 

mord 

-  - 

attr 

nadir 

ndr 

-  - 

desc  point  below  surface  observation 

name 

name 

-  - 

desc  literal  value  of  object 

next 

next 

-  - 

desc 

north 

n 

-  - 

desc  0  degrees 

northeast 

ne 

-  - 

desc  45  degrees 

northwest 

n  w 

-  - 

desc  315  degrees 

not 

not 

-  - 

op 

nudging 

nudg 

ndg.ng 

op 

Type  Description 


Full  Name  Abbr  Name  Short 


number 

num 

nu 

numeric 

nmrc 

nmc 

observation 

ob 

0 

occupies 

occp 

-  - 

ocean 

ocn 

-  - 

oe 

oe 

-  - 

operational 

oper 

-  - 

operator 

op 

-  - 

ordinal 

ord 

-  - 

output 

oput 

op 

particle 

prtc 

pc 

past 

past 

-  - 

path 

path 

pth.ph 

per 

per 

pe 

period 

perd 

-  - 

permanent 

perm 

-  - 

pk 

pk 

-  - 

point 

pt 

.  - 

points 

pts 

P 

precipitable 

prcl 

-  - 

present 

prst 

-  - 

pressure 

pres 

-  - 

prevailing 

prvl 

pr 

previous 

prev 

pv 

primary 

prim 

-  - 

print 

prnt 

prt 

probability 

prbl 

-  - 

profiles 

prof 

prf.pf 

put 

put 

-  - 

q 

q 

-  - 

qualitative 

qltv 

-  - 

radiation 

rdtn 

-  - 

radius 

rad 

ra 

Rafos 

rafs 

raf 

ramp 

ramp 

-  - 

random 

rndm 

-  - 

ivar  index  into  series  of  objects 

desc 

desc 

desc 

desc 

attr  info  about  orbital  element 
desc 

attr  operation  to  perform 

desc 

op 

desc 

desc 

desc 

op 

desc  duration  of  interval  event 
desc 

desc  acronym  -  primary  key 

desc 

desc 

desc 

desc 

rvar 

desc 

desc 

desc 

op 

op 

desc 

op 

desc  terrain  resolution 

desc 

rvar 

rvar 

desc 

op 

desc 
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range 

rang 

-  - 

desc 

rate 

rate 

rat 

desc 

read 

read 

rd 

op 

references 

ref 

-  - 

desc 

relative 

rltv 

-  - 

desc 

remark 

rmrk 

-  - 

desc  addendum  for  clarity 

report 

rpt 

-  - 

desc 

request 

rqst 

rq 

op 

requester 

reqr 

-  - 

desc 

requires 

req 

-  - 

desc 

research 

rsch 

-  - 

desc 

resembles 

rsmb 

— 

desc 

resolution 

rslt 

-  - 

desc 

responsible 

resp 

-  - 

desc 

return 

rtn 

rt 

op 

right 

rht 

r 

desc 

Rossby 

rsby 

-  - 

desc 

salinity 

salt 

sal, si 

rvar 

satellite 

sat 

St 

attr 

save 

save 

sv 

op 

scale 

scl 

sc 

op 

sea 

sea 

se 

desc 

second 

2 

-  - 

desc 

secondary 

scdy 

-  - 

desc 

seconds 

sec 

-  - 

desc 

sensible 

snsb 

-  - 

desc 

sensor 

sens 

-  - 

desc 

shallow 

shlw 

-  - 

desc 

shear 

shr 

-  - 

rvar 

ship 

ship 

-  - 

desc 

sigma 

sgma 

-  - 

rvar 

significant 

sig 

-  - 

desc 

simple 

smpl 

sp 

desc 

size 

size 

sz 

attr 

smooth 

smth 

-  - 

desc 

solar 

sol 

-  - 

desc 

Full  Name _  Afrbr  Name  Short _ Typo  Description 


sonic 

snc 

-  - 

desc 

sounder 

sndr 

-  - 

desc 

sounding 

sndg 

-  - 

desc 

south 

s 

-  - 

desc  180  degrees 

southeast 

se 

-  - 

desc  135  degrees 

southwest 

sw 

-  - 

desc  225  degrees 

space 

spc 

-  - 

desc 

spawns 

spwn 

-  - 

op 

speed 

spd 

-  - 

rvar 

squared 

sqrd 

sq 

op 

start 

strt 

-  - 

desc 

station 

stn 

-  - 

desc 

step 

step 

-  - 

desc 

stream 

strm 

-  - 

desc 

stress 

strs 

str 

rvar 

subjective 

sbj 

-  - 

desc 

subordinate 

sub 

-  - 

desc 

subset 

sbst 

ss 

desc 

sum 

sum 

-  - 

op 

superior 

supr 

-  - 

desc 

surface 

surf 

sf 

desc 

Sverdrup 

sver 

-  - 

attr 

temperature 

temp 

tp 

rvar 

temporary 

tmp 

-  - 

desc 

terrain 

terr 

-  - 

desc 

text 

text 

txt 

desc  qualitative  info,  in  text 

thermocline 

thcl 

-  - 

desc 

third 

3 

-  - 

desc 

threshold 

thld 

-  - 

desc 

time 

tm 

t 

desc  absolute  time 

topography 

topo 

-  - 

desc 

total 

totl 

ttl 

desc 

track 

trek 

tk 

desc 

transformation 

trf  m 

-  - 

op 

transient 

trns 

-  - 

desc 

transport 

tprt 

-  - 

desc 

Full  Name  Abbr  Name  ShorL  _ Typo  Description 


turbulence 

trbl 

trb, 

type 

type 

ty 

u 

vldm 

-  - 

ucomponent 

ucmp 

-  - 

unexpanded 

unxp 

-  - 

unit 

unit 

u 

units 

unts 

us 

update 

updt 

ud 

upper 

uppr 

up 

urban 

urbn 

urb 

uses 

use 

-  - 

usn 

usn 

-  - 

V 

v2dm 

-  - 

valid 

vald 

-  - 

value 

val 

-  - 

variable 

vrbl 

vb 

variance 

var 

-  - 

vcomponent 

vcmp 

-  - 

velocity 

vel 

V 

vertical 

vert 

vr 

viscosity 

vise 

vs 

visible 

vis 

-  - 

vorticity 

vort 

-  - 

w 

v3dm 

-  - 

warming 

wrmg 

-  - 

water 

wtr 

-  - 

wave 

wav 

-  - 

wban 

wban 

-  - 

weather 

wthr 

-  - 

weight 

wght 

w  t 

west 

w 

-  - 

wetbulb 

wetb 

-  - 

whitecap 

wcap 

-  - 

width 

wdth 

-  - 

wind 

wind 

wnd 

wmo 

wmo 

-  - 

desc 

attr  selection  from  a  category 

rvar  velocity  in  first  dimension 

desc 

desc 

desc 

desc 

op 

desc 

desc 

desc 

desc  US  Navy 

rvar  velocity  in  second  dimension 
desc 

desc  numeric  represent,  of  quantity 

desc 

desc 

desc 

rvar 

desc 

rvar 

desc 

rvar 

rvar  velocity  in  third  dimension 

desc 

desc 

desc 

desc  weather  bureau  Air  Force  Navy 

desc 

desc 

desc  270  degrees 

attr  wetbulb  thermometer 

desc  crest  of  wave  is  foam 

desc 

rvar 

desc  World  Meteoro.  Organization 
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Full  Name 

Abbr  Name 

Short 

word 

word 

write 

w  rt 

w  r 

xtom 

xtom 

-  - 

yaw 

yaw 

-  - 

year 

year 

yr 

zenith 

zen 

-  - 

zonal 

znl 

-  - 

zone 

zone 

-  - 

3.0  netCDF 

JACKETS 

_ Type  Description _ 

desc 

op 

desc  computation  excludes  toms 
op  rotation  about  vertical  axis 
desc 

desc  vertically  above  observation 

desc 

desc 


The  netCDF  jackets  are  responsible  for  mapping  model  variable 
names  to  the  netCDF  long  and  short  abbreviated  names  given  in  the  data 
dictionary.  Complex  names,  consisting  of  underscore-concatenated  long 
form  abbreviations,  are  used  for  the  netCDF  file  variable  names  whenever 
possible.  Short-form  abbreviations  are  concatenated  without  the 
underscore.  In  length-limited  programming  languages,  the  shorter 
abbreviations  are  used  in  the  netCDF  file. 

4.0  SEMI-SPECTRAL  PRIMITIVE  EQUATION  MODEL  (SPEM) 
netCDF  EXAMPLE 

This  section  includes  the  currently  defined  mappings  for  SPEM  [1]. 
We  map  the  SPEM  variable  names,  which  are  listed  in  the  column  “model”, 
to  the  “Short-form”  column  abbreviations  available  in  the  netCDF  file 
because  SPEM  is  a  FORTRAN  program. 


Model 

Long 

netCDF 

Short 

netCDF  DescriDtion 

disp 

flag_dcd 

fldcd 

dt 

time_step 

dt 

dtyp 

datatype 

dty 

h 

ht 

ht 

idat 

date 

date 

ipre 

flag-P^ev 

flpr 

Model 


Long 


Short 

netCDE 


ire  flag_rtn_code 

irng  data_iflc 

irpt  logc_unit_rpt 

irw  flag_rd_wrt 

irptr  dens_ob_lctn_1_dim 

isave  flag_.save 

iupd  flag_updt 

iuptr  1_dim_vel_ob_lctn_1_dim 

ivptr  2_dim_vel_ob_lctn_1_dim 

ixb  arry_size_bgn_1_dim 

ixe  arry_size_end_1_dim 

iyb  arry_size_bgn_2_dim 

iye  arry_size_end_2_dim 

izb  arry_size_bgn_3_dim 

ize  arry_size_end_3_dim 

jrptr  dens_ob_lctn_2_dim 

juptr  1  _dim_vel_ob  _lctn_2_dim 

jvptr  2_dim_vel_ob_lctn_2_dim 

krptr  dens_ob_lctn_3_dim 

kuptr  1_dim_vel_ob_lctn_3_dim 

kvptr  2_dim_vel_ob_lctn_3_dim 

I  1_dim_grid_size 

loca  Ictn 

m  2_dim_grid_size 

mtppt  max_topo_size 

n  3_dim_grid_size 

nptlg  num_pts_lon 

nptlt  num_pts_lat 

numr  dens_ob_size 

numu  1  _dim_vel_ob_size 

numv  2_dim_vel_ob_size 

psi  vort 

rampuv  per 

rclm  dens_clmo 

rdata  dens  data 


flrtcd 

diflc 

lurpt 

flrdwr  -  - 
dnlodm  -  - 
flsv 
flud 

vl  lodm  -  - 

v21odm  -  - 

bldm 

edldm 

b2dm 

ed2dm 

b3dm 

ed3dm 

dn2odm  -  - 

v12odm  -  - 

v22odm  -  - 

dn3odm  -  - 

v13odm  -  - 

v23odm  -  - 

Idmgr 

Ictn 

2dmgr 

toposz  -  - 

gr3dm 

nplon  grid_size 

nplat  grid_size 

dnodm 

vlodm 

v2odm 

vort 

per  period  to  interpolate  thru 

dnclmo  -  - 

dnd 
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Model 

Long 

netCDF 

Short 

netCDF 

rdcy 

arry_data_iflc 

aradif 

resol 

rslt 

rslt 

rho 

dens 

dens 

r  II  It 

lowjeft  Jat 

Iwllat 

rllng 

low_left_lon 

Iwllon 

robs 

dens.ob 

dno 

ros2 

cnst_rsby_rad 

rsbyrd 

rrdec 

dens_coef_assm 

dncas 

rudec 

1  _dim_vel_coef_assm 

vlcas 

rvdec 

2_dim_vel_coef_assm 

v2cas 

scalf 

scl_fctr 

sclftr 

ssbathy 

sbst.toposstopo 

-  - 

ssllg 

sbst_low_left_lon 

sslwll 

sslllt 

sbst_low_left_lat 

sslwl2 

ssurlg 

sbst_uppr_rht_lon 

ssuprl 

ssurlt 

sbst_uppr„rht_lat 

ssupr2 

t 

curr.tm 

currtm 

tdata 

elps_tm 

elpstm 

tobs 

ob_tm 

obtm 

u 

1_dim_vel 

vldm 

uclm 

1_dim_vel_clmo 

vldmcl 

udata 

1_dim_vel_data 

vldmd 

uobs 

1_dim_vel_,ob 

vldob 

urlat 

uppr_rht_lat 

uprlat 

urlng 

uppr_rht_lon 

uprion 

V 

2_dim_vel 

v2dm 

vdata 

2_dim_vel_data 

v2dmd 

vclm 

2_dim_vel_clmo 

v2dmcl 

vobs 

2_dim_vel_ob 

v2dob 

w 

3_dim_vel 

v3dm 

5.0  DATA  SPACE 


coverage,  geographic,  location 
coverage,  geographic,  location 

Rossby  radius 


domain.values  or  coverage 
domain.values  or  coverage 
domain.values  or  coverage 
domain.values  or  coverage 

time  since  last  data  assimilation 


There  are  many  “standard”  data  structures  in  data  space.  The  best 
structure  for  each  data  type  with  respect  to  storage,  retrieval,  and  update 


needs  are  still  open  issues.  In  this  section,  with  an  eye  towards  the 
future,  we  set  down  the  contents  of  groups  of  data  by  collection 
instruments.  The  instrument  is  listed  and  then  some  of  the  data  types  we 
might  expect  to  be  associated  with  that  instrument  are  listed  under  it. 

When  a  data-type  abbreviation  is  so  familiar  as  to  be  a  default 
name,  it  is  used  instead  of  a  sentence.  One  might  consider  these  idioms. 

ADP: 

acst_dplr_prof  (adp) 
vel_prof_vert  (vprfvr) 

CTD: 

curr_temp_dens  (ctd) 

Gross  Feature  Locations  (Bogus  Maps): 
mndr 
eddy 

frnt_trak  (frnttk) 

Hydrography: 

Hydr 

sea_surf_ht  (ssh) 
sea_surf_temp  (sst) 

Inverted  Echo  Sounders: 
inv_echo_sndr  (ies) 
sea_surf_ht  (ssh) 

Path  Characteristics: 
path_char  (pthchr) 
dspl 

ang_prtc_path  (agpcph) 
curvature  (curv) 
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Satellite  Altimetry: 
sat_altm  (satal) 
sea_surf_ht  (ssh) 
infr  (infr) 


VTP: 

vel_temp_pres  (vtp) 

6.0  CONSTANT  VALUES 

For  actual  numbers,  the  value  can  be  concatenated  with  the  unit  or 
type.  For  example  10  -  minutes,  or  the  associated  short  form  lOmnts,  can 
be  used  for  a  constant  time  value  of  ten  minutes. 

7.0  CONSTRAINTS  ON  DATA  ITEMS 


Some  words  are  not  allowed  because  other  words  are  equivalent  and 
“better”  in  some  sense.  The  following  words  are  not  to  be  added  to  the 
data  dictionary  in  Section  2: 


altitude 

average 

datetime 

definition 

increment 

mode 

quantity 


use  height  or  elevation 

use  mean 

use  time 

use  description 

use  interval 

use  description  or  type 

use  amount 


8.0  VALIDATION  CRITERIA 


This  section  discusses  how  we  will  know  that  the  netCDF  data 
dictionary,  utilities,  and  subroutines  are  preforming  correctly.  It  will  be 
the  basis  for  the  system  tests. 
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8.1  Performance  Bounds 

The  netCDF  interfaces  must  add  no  more  than  twenty  percent 
overhead  to  the  model  run,  and  we  would  like  to  see  no  more  than 
five  percent. 

An  associated  software  report  routine  will  be  called  to  document 
each  netCDF  activity  to  disk.  This  report  will  document  that  the 
communications  we  expected  to  take  place  did  in  fact  occur. 

8.2  Test  Cases 

Our  timing  test  case  will  run  the  models  with  and  without  the 
netCDF  interface,  and  time  the  run  costs  of  each  to  determine  the 
percentage  of  overhead.  This  will  be  done  averaged  over  five  separate 
overall  tests  to  subtract  out  system  load  affects,  and  over  five  separate 
cases  for  each  module  interface. 

The  software  results  should  be  equivalent  in  all  respects,  except 
performance,  up  to  the  level  of  precision  used  by  the  netCDF  file  format. 
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